home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 41 / Amiga Format CD41 (1999-06)(Future Publishing)(GB)[!][issue 1999-07].iso / -seriously_amiga- / -commercial- / pagestream_filter / readme < prev    next >
Text File  |  1999-04-24  |  9KB  |  234 lines
  1.  
  2.         Studio's Universal Filter V1.5
  3.  
  4.  
  5. Introduction
  6.  
  7.  
  8. The  'Universal'  filter  allows  reading  many image formats with
  9. PageStream   V3.x/V4.x   wich   are  not  originaly  supported  by
  10. PageStream.  It also allows formats like IFF ILBM and others to be
  11. loaded much faster (300%).
  12.  
  13. The  'Universal'  filter  is  based  on  the  development  for the
  14. CanonStudio  shareware  printing program and the commercial Studio
  15. printer  software.   It is totaly free to owners of this software.
  16. It  is  shipped  with  the CanonStudio CDROM and is also available
  17. online for all older CanonStudio V2.x and Studio V2.1x users.
  18.  
  19. For  those who don't know Studio or CanonStudio:  this is software
  20. containing  various  printer software and application not only for
  21. use  with PageStream.  But it also includes a PageStream V3.x/V4.x
  22. driver  that  really can dramaticly improve your PageStream prints
  23. and add additional features.
  24.  
  25.  
  26. Requirements
  27.  
  28.  
  29.  - PageStream V3.1, V3.2, V3.3, V3.4, V4.0 or newer
  30.  - You must be owner of CanonStudio or Studio to install this
  31.    software. However, it is not required to have the CanonStudio
  32.    or Studio software installed.
  33.  
  34.  
  35. Features
  36.  
  37.  
  38. The  Universal  filter  basicly does support all the image formats
  39. that  are  also  available in CanonStudio or Studio in PageStream.
  40. But  it  does not only add support for many new graphic formats to
  41. PageStream.   Often  the  Universal  filter is MUCH faster and can
  42. load far more types of images.  For instance, the Universal Filter
  43. supports nearly all type of TIFF images available. Seeing a speed
  44. increase of 300% on loading IFF ILBM images is nothing unusual....
  45.  
  46. Supported formats are:
  47.  
  48.       BMP:  1,  4, 8, 16 and 24 Bit, Windows V3 and OS/2 format,
  49.             RLE4, 8, 24 compression
  50. DataTypes:  OS 3.0 DataTypes
  51.       DCX:  only the first image is printed
  52.       GIF:  supports 87a and 89 format
  53.  IFF ILBM:  including HAM, HAM8, EHB,...
  54.  IFF DEEP:  24 Bit RGB and RGBA, supports compression
  55.      JPEG:  8 Bit and 24 Bit JFIF, progressive JPEG
  56.       PCX:  1,2,4,8 and 24 Bit images
  57.       PGM:  8-bit
  58.       PNG:  incl. interlaced
  59.       PPM:  24-bit
  60.     Targa:  supports all known RGB, RGBA types incl. compression
  61.      TIFF:  1-64 Bit, RGB, RGBA, CMYK, YCbCr with None, PackBits,
  62.             RLE, JPEG, G3, G4, LZW and Next compression, Strips
  63.             or Tiles, Packed or separate color
  64.  
  65. As  you  can see, it does support several additional image formats
  66. and  does  replace  some  filters  shipped with PageStream.  Don't
  67. worry   about  compatibility.   You  can  still  use  the  limited
  68. PageStream filters if wanted.
  69.  
  70.  
  71. Installation
  72.  
  73.  
  74. Simple... run in the install program from the Workbench and it
  75. will do the trick. Next time you load an image in PageStream, you
  76. might get the "Studio's Universal Filter" offered when loading
  77. images. Choose it to make use of it.
  78.  
  79.  
  80. Tech Info
  81.  
  82.  
  83. Some more info about the Universal loader:
  84.  
  85. - Why this filter?  Simply because it didn't cost me much work and
  86. I  made  it  free  to  CanonStudio  and Studio owners in hope that
  87. someone  finaly  finds the time to forward images to me that don't
  88. get  loaded  by  the  Universal  loader.   So it's a way I hope to
  89. advance my image reading routines and make them work on nearly all
  90. images.   You  already  will  find  that it really works with MANY
  91. images where similar other software on the Amiga fails.
  92.  
  93. So,  please, if you do have problems loading an image, let me know
  94. of  it  and  just  don't switch to a different format to work with
  95. PageStream.   I  want the Universal loader to work with all images
  96. with formats supported.
  97.  
  98. - PageStream currently does only use the filter when importing the
  99. image.   Once  loaded,  it  the image is saved with the PageStream
  100. document  file without further need for the filter unless you left
  101. the  image  external in PageStream.  In this case, the filter will
  102. be  used  when  loading the images in the document again.  In case
  103. the  filter  is  not  available,  PageStream currently automaticly
  104. prompts the filerequester with the file to be loaded again using a
  105. different  filter.   So,  basicly,  it's  safe to usethe universal
  106. filter.   I  will  keep  it  updated in case Softlogik changes the
  107. filter interface.  And in case you run into trouble in the future,
  108. you shouldn't have any problems switching to a different filter.
  109.  
  110. So  using  the  Universal  filter  is  save for the future of your
  111. documents.   If  you  want to share document files with PageStream
  112. users without the Universal filter, simply make sure the images in
  113. your  document.   Or  better:   ask  the user to get the Universal
  114. loader ;-)
  115.  
  116. -  The  filter  does  load  all  images  as 8 Bit/24 Bit images in
  117. PageStream.   I  don't see much of a problem here as processing is
  118. done  in  this  format  by PageStream internaly anyway.  It's just
  119. noted  here  because  the image information shown in PageStream on
  120. request might lead you to wrong thinking...
  121.  
  122. - Memory requirement. I know some PageStream users are running out
  123. of memory. So here is some info that might be usefull. PageStream
  124. does load all graphics filters during it's start. This means, a
  125. XYZ format filter does require memory on your machine even if you
  126. never will use the XYZ format.
  127.  
  128. So  if  you  are  low  on  memory,  you might think about removing
  129. filters  from the PageStream3:Softlogik/filters drawer to a backup
  130. drawer on your harddisk. This way you might gain 100-300KBytes of
  131. precious memory. Sure, buying more memory should be the first
  132. choice....
  133.  
  134. - The image reading routines used by the Universal filter do allow
  135. reading  images  line  by  line from disk without need for memory.
  136. But  PageStream  doesn't  make  any  use of it.  So I'm afraid you
  137. still  need  lot's of memory to load the image in PageStream.  The
  138. is  even  a  catch:   if  you  are  very  low  on free memory, the
  139. Universal  filter might automaticly switch to a slower 'low memory
  140. consumption'.   This  means,  it will need less memory to load the
  141. image,  but  than, the filter might get much slower.  This is only
  142. the  case  in  some formats (some TIFF and interlaced TARGA images
  143. are effected).
  144.  
  145. So  when doing benchmarks with the Universal load under low memory
  146. conditions,  please  have  this  in  mind  when loading these rare
  147. images affected.
  148.  
  149.  
  150.  
  151. Known Bugs??
  152.  
  153. There  are  no known bugs.  If you do have an image in a supported
  154. format  that  is not loaded by the Universal filter, please report
  155. to:
  156.  
  157. Wolf Faust
  158. Am Dorfgarten 10
  159. 60435 Frankfurt
  160. Germany
  161.  
  162. email: 100116.1070@compuserve.com
  163.   Fax: ++44-69-95409598      (NO REPLY IS GIVEN VIA FAX!)
  164.  
  165. Please note in your report:
  166.  
  167. 1. What application was used to write the image you have trouble
  168.    with? What type of image is it (size, colors,...) ?
  169.  
  170. 2. What PageStream and Universal Filter version are you using?
  171.  
  172. 3. If possible, enclose a sample image (DO NOT SEND IMAGES AS
  173.    EMAIL WITHOUT GETTING ASKED FROM ME)
  174.  
  175. 4. How do you exactly load the image in PageStream?
  176.    Via Menu? Via ARexx???
  177.  
  178.                       COPYRIGHT/DISCLAIMER
  179.                       ====================
  180.  
  181. Copyright   ©1997-99   Wolf  Faust.   All  rights  reserved.   All
  182. distribution-  and  marketing rights to the software are vested in
  183. Wolf  Faust.   The software and documentation has been provided to
  184. you  strictly  'as is', without warranty of any kind.  In no event
  185. shall  Mr.   Faust  be held liable for any loss or damages arising
  186. out  of  any  action,  from whatever source, concerning the use or
  187. inability  to use the product.  You may not use, copy, or transfer
  188. the  product,  or  any  copy  or portion, without prior consent in
  189. writing from or Wolf Faust.
  190.  
  191. Installer   and  Installer  project  icon  (c)  Copyright  1991-93
  192. Commodore-Amiga,   Inc.   All  Rights  Reserved.   Reproduced  and
  193. distributed  under  license  from  Commodore.   More (c) Copyright
  194. 1986-93  Commodore-Amiga,  Inc.   All Rights Reserved.  Reproduced
  195. and distributed under license from Commodore.
  196.  
  197. INSTALLER  SOFTWARE  IS PROVIDED "AS-IS" AND SUBJECT TO CHANGE; NO
  198. WARRANTIES  ARE  MADE.  ALL USE IS AT YOUR OWN RISK.  NO LIABILITY
  199. OR  RESPONSIBILITY  IS  ASSUMED.   THE  More  PROGRAM  IS PROVIDED
  200. "AS-IS" AND SUBJECT TO CHANGE; NO WARRANTIES ARE MADE.  ALL USE IS
  201. AT YOUR OWN RISK.  NO LIABILITY OR RESPONSIBILITY IS ASSUMED.
  202.  
  203.  
  204. THANKS
  205.  
  206.  
  207. At last a big thanks to the people (Deron, Gary...) at SoftLogik
  208. providing info, software and help to make this filter possible.
  209.  
  210.  
  211. History
  212.  
  213.  
  214. 16.09.97 V1.1 - First public version based on Studio V2.15
  215.         for test purpose.
  216. 18.09.97 V1.2 - BME's filerequester tried to loadcheck drawers
  217.         causing an error requester by Universal as no
  218.         drawer can be read...
  219.           - If loading a picture object with Datatype
  220.         fails, no error requester is displayed
  221.           - An error requester is displayed if the
  222.         SL_SystemInit() call to SL code fails
  223.         (bad PageStream version?) during the
  224.         start of PageStream.
  225. 24.09.97 V1.3  - Non-Standard IFF ILBM B/W 1 Bit without colormap
  226.          files saved by BME/PageStream are now loaded.
  227. 02.11.98 V1.31 - Now also checks/installs for PageStream V4 assign
  228. 02.02.99 V1.4  - DPI Information is now fowarded for PNG/IFF DEEP.
  229. 17.04.99 V1.5  - AsyncIO library caused crashes with interlaced
  230.                  GIF. Removed AsyncIO until author fixed that library.
  231.                - GIF now does much less Seek() calls.
  232.  
  233. (Continue by pressing 'Q')
  234.